Inside Macintosh: QuickTime Components /

Chapter 3 - Standard Image-Compression Dialog Components / Standard Image-Compression Dialog Components Reference

Standard Image-Compression Dialog Component Functions / Compressing Image Sequences

SCCompressSequenceBegin

The SCCompressSequenceBegin function initiates a sequence-compression operation. You supply the first image in the sequence so that the component can determine its spatial and graphical characteristics.

pascal ComponentResult SCCompressSequenceBegin 
                              (ComponentInstance ci, 
                                 PixMapHandle src, Rect *srcRect, 
                                 ImageDescriptionHandle *desc);

ci

Identifies your application's connection to a standard image-compression dialog component.

src

Contains a handle to the pixel map to be compressed. This pixel map must contain the first image in the sequence.

srcRect

Contains a pointer to a portion of the pixel map to compress. This rectangle must be in the pixel map's coordinate system. If you want to compress the entire pixel map, set this parameter to nil.

desc

Contains a pointer to an image description handle. The standard dialog component creates an image description structure when it compresses the image, and returns a handle to that structure in the field referred to by this parameter. The component sizes the handle appropriately. If you do not want this information, set this parameter to nil.

The returned structure is valid for the entire sequence. The standard dialog component disposes of the handle when you end the sequence by calling the SCCompressSequenceEnd function. Your application must not dispose of this handle by any other means.

RESULT CODES

Memory Manager errors
Image Compression Manager errors (from CompressSequenceBegin function)

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help